home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / butility / get26.zip / RUN.DOC < prev    next >
Text File  |  1991-12-07  |  3KB  |  69 lines
  1. RUN.EXE Version 1.0, Copyright (c) 1991 Bob Stephan
  2. All rights reserved.  FREE for personal use.
  3.  
  4. RUN permits you to view the ErrorLevel from a program without having 
  5. to use a long, slow BATch file to check for every possible ErrorLevel.
  6.  
  7. The syntax is:
  8.  
  9. RUN drive:\path\filename.ext arguments
  10.  
  11. where "filename" is the name of the program you want to run. It must 
  12. be qualified with the full drive, path, and the correct .COM or .EXE 
  13. extension.  The only exception is if the target program is in the 
  14. current directory in which case the drive and path may be omitted, but 
  15. the extension is required in all cases.  You can use .. for the parent 
  16. directory of the current subdirectory, and . for the current 
  17. directory, however the latter is not needed since it will default to 
  18. the current directory.
  19.  
  20. RUN is for .COM and .EXE programs only.  It does not run BATch files, 
  21. but since they do not return ErrorLevel codes, it is of no use for 
  22. BATch files anyway.
  23.  
  24. "arguments" are the normal arguments (parameters, switches, file 
  25. names, etc.) that you would use for the program if you were running it 
  26. from the DOS prompt.
  27.  
  28. If your program terminates normally, RUN will report:
  29.  
  30. RUN regained control!
  31. Child termination type=00h, return code=xxx
  32.  
  33. where "xxx" will be the ErrorLevel code returned by your program. 
  34. The same code will be placed in the ErrorLevel by Run where it can
  35. be checked with the IF ERRORLEVEL subcommand in a BATch file.
  36.  
  37. If the termination is not normal, you will see one of the following:
  38.  
  39. If you terminate the program with Ctrl-Break or Ctrl-C:
  40. RUN regained control!
  41. Child termination type=01h, return code=0
  42.  
  43. If you answer A to "Abort, Retry, Fail":
  44. RUN regained control!
  45. Child termination type=02h, return code=0
  46.  
  47. If RUN is unable to run your program, you might see one of the 
  48. following:
  49.  
  50. EXEC call failed, error code=02h.
  51. File not found - check for drive, path, filename, and extension.
  52.  
  53. EXEC call failed, error code=03h.
  54. Path not found - check drive and path.
  55.  
  56. EXEC call failed, error code=04h.
  57. Too many open files.
  58.  
  59. EXEC call failed, error code=05h.
  60. Access denied - check for .EXE or .COM extension.
  61.  
  62. EXEC call failed, error code=08h.
  63. Not enough memory.
  64.  
  65. If you have any questions, comments, or suggestions please contact me at:
  66.     MOBY DISK: 1021 San Carlos Road, Pebble Beach, CA 93953
  67. Phone: (408) 646-1899/1373.    GENIE:MOBYDISK.      COMPUSERVE:72357,2276
  68. BBS: The Cricket 408-373-3773         /s/ Bob Stephan   November 27, 1991
  69.